home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / program / misc / fpl-v13.lha / fpl / HISTORY < prev    next >
Text File  |  1995-09-25  |  12KB  |  326 lines
  1. HISTORY of changes
  2.  
  3. Syntax description:
  4.     * Bug fix
  5.     + New feature
  6.     - Note/change
  7.     : Obsolete/old stuff
  8.  
  9. ------------------------------------------------------------------------------
  10.  
  11. 13.8    + A single character access (from a string) were accepted in places
  12.       where strings are required.
  13.  
  14. 13.7    + If FPLTAG_ISOLATE is used in a fplExecuteXXXX() call, the program
  15.       run can't access nor declare any exported identifiers. Only
  16.       external, internal and those it creates within its own program.
  17.       (FPLTAG_ISOLATE forces all 'export' variables to be treated as
  18.       regular globals.)
  19.  
  20. 13.6    * Fixed a stupid read from NULL that could occur at strange times...
  21.  
  22. 13.5    * Executing files that only declared/exported variables/funcitons
  23.       repeatedly wasn't taken care of properly...
  24.  
  25.     * a fplAddFunction()-call with an already existing name didn't make
  26.       FPL happy... (still doesn't, but now it survives!)
  27.  
  28. 13.4    * rename() to "" returned a very random number.
  29.  
  30.     * The FPLSEND_GETSYMBOL_* didn't work properly if the hash table size
  31.       was altered.
  32.  
  33. 13.3    * fplAddVariable() that added a string with NULL as default string
  34.       did crash.
  35.  
  36. 13.2    * ltostr() didn't work properly on numbers like 1<<31...
  37.  
  38.     + [Amiga] FPLdb is much improved. It's now cabable of showing
  39.       function return codes and a few other things as well as it can be
  40.       controlled through ARexx and even disabled/enabled.
  41.  
  42.     * Setting DEBUG_MODE with the fplReset() or in the fplInit() will now
  43.       switch on/off "global" debug mode. That is everything will be run in
  44.       debug mode. Previously, they only switched it on and off just like
  45.       the 'debug()' function, which made them pretty useless...!
  46.  
  47. 13.1    * External functions that were expected to return a string, but
  48.       didn't, could make FPL rather confused... I even improved
  49.       interpreting speed pretty much when strings are returned from
  50.       external functions.
  51.  
  52.     : [Amiga]
  53.       FPLTAG_LOCKUSED is removed. There is no substitute, but I doubt
  54.       anyone will ever miss it...
  55.  
  56.     * sprintf() now has some better checks when using more %-codes than
  57.       parameters
  58.  
  59.     + 'rename' can change name of already existing identifiers. By using
  60.       this the right way, you can alter the working of *any* already
  61.       written or added function in FPL. Even external or internal ones!!
  62.  
  63.     + exists() returns information about the presence of identifiers.
  64.  
  65. 13.0    + sscanf() is here!
  66.  
  67.     + [Amiga]
  68.       FPLdb version 2 is introduced and needed if you want to debug FPL
  69.       from now on! A couple of new switches and cleaned code have gotten
  70.       be started to create a better and more advanced debugger.
  71.  
  72. 12.6    + The interpreter makes much better assumptions and errors now about
  73.       functions that return optional types. An example, we have a function
  74.       called 'myown()' that has been added by the program to return
  75.       optional string or int. Previously, uses like this caused problems:
  76.         int a;
  77.         a = myown("return string!"); /* this returned a string */
  78.  
  79.     * Removed an error that would occur when an integer was returned
  80.       from a function returning optional type, when FPL expected a string!
  81.  
  82.     * The following little program stopped with 'Out of memory error!':
  83.       string hi()
  84.       {
  85.          string p;
  86.              return p;
  87.           }
  88.       hi();
  89.  
  90.     * Using variable references as parameters to inside functions could
  91.       mess up the return-value of the function!!!
  92.  
  93. 12.5    * A string that ended with a single backslash confused
  94.       fplConvertString().
  95.  
  96. 12.4    + fplStrtol() now accepts NULL in the third parameter.
  97.  
  98. 12.3    * Accessing the first column of an empty string will now generate
  99.       an "Illegal string index error" instead of simply crashing...
  100.  
  101.     * If sprintf() didn't make a string (or a zero-length), FPL could
  102.       write to a stupid address (0x000004) ...
  103.  
  104. 12.2    - FPL now keeps a good control of the "break level". Thereby, it can
  105.       alert much better on breaks with too high level and other illegal
  106.       uses (like using break outside of loops and switches).
  107.  
  108.     * 'continue' is now harder to abuse.
  109.  
  110.     * FPL could loose track of the real line number when passing if()-
  111.       statements that wasn't evaluated.
  112.  
  113.     + Added the FPLSEND_GETVERSION and FPLSEND_GETREVISION to enable
  114.       the FPL library user to get FPL version and revision number.
  115.  
  116. 12.1    * Using nested switch()-statements actually had a high fail ratio
  117.       since FPL would find the 'case' - labels of "inner-level"
  118.       switch()es !
  119.  
  120.     + Included all the xxxxxxxTags() functions to the actual library
  121.       instead of have them as separate stubs. Not made for the Amiga
  122.       library.
  123.  
  124. 12.0    + The previous feature that enables string merging like:
  125.         string a = b + c;
  126.       where b and c are strings, is re-implemented!
  127.  
  128. 11.6    * 'continue' within statements that wasn't within braces didn't
  129.       work as it should!
  130.  
  131. 11.5    * [Amiga] The internal table of funclibs did not survive after the
  132.       program that opened a funclib quit! Now it does...
  133.  
  134.     * [Amiga] Added RESETOPTIONS to the compiler flags to ignore all those
  135.       *stupid* ENV:sc/SCOPTIONS used by people who try to compile FPL...
  136.  
  137. 11.4    * "\x" didn't work with uppercase letters in the hexadecimal number!
  138.  
  139.     * Accessing an array illegally when *not* declaring, made FPL to
  140.       strcpy() a NULL pointer...
  141.  
  142.     * Assigning a string variable like
  143.         string a,b;
  144.         a = b
  145.       where 'b' never was initialized could lead to 'out of memory'!
  146.  
  147. 11.3    + stristr(), stricmp() and strnicmp() were added to the language!
  148.  
  149. 11.2    * Another small fix to break-within-switch. This is the third in a row
  150.       of bugs discovered by Björn when I've been planning to make a public
  151.       release...!
  152.  
  153.     * Argh!! Forgot to check if it really was a break that broke a
  154.       switch(), which made strange results on i.e return()s from within
  155.       switch()es...!
  156.  
  157.     * Breaks within a switch() could get left after the switch() statement
  158.       so that one 'break' happened to break out of several levels!
  159.  
  160.     * Using 'break' with a too high level parameter now results in the
  161.       (much better) 'illegal break' error message...
  162.  
  163. 11.1    Released to Björn for test use in FrexxLink
  164.  
  165.     * The 'break' keyword didn't work in a program like:
  166.       while(1) {
  167.         if(1) {
  168.               if(1)
  169.                 break;
  170.             }
  171.             /* shouldn't reach this but did previously! */
  172.           }
  173.     
  174. 11.0    Pre-release only used by a minimum of people.
  175.  
  176.     * [Amiga] funclib/lib.c didn't remove the "libTest2" function on exit!
  177.  
  178.     * #pragma nocache was no real success if FPL decided that the program
  179.       was subject for caching...
  180.  
  181.     * Cleaned up a bit more, and made more functions return proper error
  182.       messages.
  183.  
  184.     + Seven new error messages have been added to help debugging FPL
  185.       programs. The new ones are more specified of what exactly the error
  186.       is. Of course I remade a few details to make them use the new
  187.       errors. Read the updated (at last) chapter in the documentation!
  188.  
  189. 10.7    * Accessing a string array with i.e foobar[-1] now generates
  190.       'illegal array "foobar" error!' instead of previous 'out of reach
  191.       error!'.
  192.  
  193.     * The since a long time known, but very-hard-to-find bug that made FPL
  194.       loose control of the line number in error messages is now removed.
  195.       It occured in situations like:
  196.  
  197.         if/while ( FALSE )
  198.           STATEMENT;
  199.  
  200.           The newlines between 'STATEMENT' and the following statement were
  201.       then counted twice...!
  202.  
  203.     * A single exported/global string variable that was assigned at
  204.       declaration time wasn't properly taken care of. Later use of the
  205.       variable could lead to crashes!
  206.  
  207. 10.6    * FPLTAG_KIDNAP_CACHED was fixed and should be working now!
  208.  
  209.     - Since we're planning a release (software based on FPL) on OS/2, all
  210.       packages from now is gonna be multi-platform. It means a few things:
  211.       o ASCII formatted docs will be included as well as the .guide ones.
  212.       o Binary versions of FPL.DLL (OS/2) and FPLlib.so (Intel SVR4 UNIX)
  213.         will be included.
  214.       o The archive directory tree now holds the directories bin_amiga/,
  215.         bin_os2/ and bin_svr4/.
  216.  
  217. 10.5    * Assigning a global/exported string variable after it had been
  218.       "globalfied", did cause a crash!
  219.  
  220.     * Deleting a global/exported variable with DelIdentifier was not
  221.       healthy...
  222.  
  223.     + Made both fplDealloc() and fplDealloca() capable of freeing memory
  224.       allcated both with fplAlloc() and fplAlloca(). They're now virtually
  225.       the same function.
  226.  
  227.     + Introducing the FPLREF_ARRAY_RESIZE... This tag to fplReference()
  228.       enables the host program to resize the array to which a reference
  229.       was sent as parameter to a function. I have to increase the library
  230.       version number for the next public/developer release!
  231.  
  232.     * Using 'resize' on arrays that were declared as global/exported
  233.       did result in system crashes!
  234.  
  235.     * Improved the error message when trying to refer to non-existing
  236.       or negative array fields. Could previously easily contain the wrong
  237.       variable name.
  238.       Did the same to illegal 'resize' operations.
  239.  
  240. 10.4    + Added FPLSEND_GETRETURNINT, which returns a pointer to the value
  241.       returned by a program. If no value was returned, this will return
  242.       NULL.
  243.  
  244.     * Fixed the fplExecuteXXXXXX() invokes that allow strings to get
  245.       returned so that the string pointer is set to NULL if a string
  246.       wasn't returned. Previous versions didn't touch the pointer in such
  247.       situations.
  248.  
  249. 10.3    * Fixed another small detail with the nested runnings and failure.
  250.       Nobody has experienced any trouble with it though.
  251.  
  252. 10.2    * Execution of nested files (and an error in a nested level) could
  253.       lead to files being cached accidentaly, which could lead to serious
  254.       confusion!
  255.  
  256. 10.1    + FPL now offers external variables to be added just like functions
  257.       have been a long time. With the function fplAddVariable(), they
  258.       will be added and recognized instantly by FPL. Added variables are
  259.       always read-only, and all reads from them causes the interface
  260.       function to get called as in a regular external function case, and
  261.       the returned value (with 'fplSend()') will be the result of the
  262.       variable read. The fplArgument struct has been extended with an
  263.       extra member which will hold the default variable result, the result
  264.       that will be the variable contents if the interface function doesn't
  265.       return anything.
  266.  
  267.     * Fixed some serious errors when FPL found 'const' variables. It did
  268.       not prevent some changes, and some changes caused peculiar error
  269.       messages!
  270.  
  271.     * Fixed a bug in the fplAllocString() which made the fplReference()
  272.       or fplSend() where the string could be used to cause damage to
  273.       the system's memory list.
  274.  
  275. 10.0    FPL VERSION 10
  276.     ~~~~~~~~~~~~~~
  277.     We've now reached version 10. The version number increase is because
  278.     of the following reasons:
  279.  
  280.     + The expression parsing is now 100% C compatible to the very last
  281.       detail AFAIK!! Expressions like the following are now treated the
  282.       C-style way:
  283.  
  284.       1) if(a++ && b++)...  the right part is only executed if the left
  285.          part was evaluated TRUE
  286.  
  287.       2) if(a++ || b++)... the right part is only executed if the left
  288.          part was evaluated FALSE
  289.  
  290.       3) if(a ? b++ : c++ )... "b++" is only executed if 'a' evaluates
  291.          TRUE, and "c++" if 'a' evaluates FALSE
  292.  
  293.     + FPL now allows array references sent as parameters to functions. Such
  294.       parameters are declared as "int *array[]" or simply "int *[]" for
  295.       integer arrays.
  296.  
  297.     + fplReference() now features:
  298.       FPLREF_TYPE_ARRAY is now a valid type bit returned by the FPLREF_TYPE
  299.       tag.
  300.       FPLREF_ARRAY_ITEM lets you set which array item you want to read or
  301.       write. The strings/ints are still read with the previous tags for
  302.       those purposes (or the new ones described below).
  303.       FPLREF_ARRAY_INFO gives you information about the looks of the
  304.       referenced array variable.
  305.       FPLREF_SET_MY_STRING makes a normal string valid as new string for
  306.       a referenced variable. The length can be set with...
  307.       FPLREF_SET_MY_STRLEN defines the length of the string set with the
  308.       tag above.
  309.  
  310.     + fplInit() features this new tag:
  311.       FPLTAG_PREVENT_RUNNING_SAME which will make FPL to abort any tries
  312.       to run a program that already is cashed. The FPLTAG_REREAD_CHANGES
  313.       tag still works fine with this though.
  314.  
  315.     + fplSend() features these new tags:
  316.       FPLSEND_RESULT which will give fplSend() a long to store results in.
  317.       FPLSEND_IS_FILE_CACHED will give information regarding if the
  318.       specified file is cached (held in memory) or not.
  319.  
  320.     + sprintf() is a new FPL function. Features all ANSI C %-codes plus
  321.       a few additional ones:
  322.       %o - octal number
  323.       %b - binary number
  324.       %n - number of characters
  325.       %P - pointer shown with uppercase letters
  326.